package cn.iocoder.yudao.module.shop.service.refundcardrecord;

import java.util.*;
import javax.validation.*;

import cn.iocoder.yudao.module.member.api.user.dto.MemberUserRespDTO;
import cn.iocoder.yudao.module.pay.dal.dataobject.wallet.PayWalletDO;
import cn.iocoder.yudao.module.shop.controller.admin.refundcardrecord.vo.*;
import cn.iocoder.yudao.module.shop.dal.dataobject.refundcardrecord.ShopRefundCardRecordDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;

/**
 * 退卡记录 Service 接口
 *
 * @author 曹建伟
 */
public interface ShopRefundCardRecordService {

    /**
     * 创建退卡记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createRefundCardRecord(@Valid ShopRefundCardRecordCreateReqVO createReqVO);

    Long createRefundCardRecord(MemberUserRespDTO member, PayWalletDO wallet, String comment, Integer refundBalance);

    /**
     * 更新退卡记录
     *
     * @param updateReqVO 更新信息
     */
    void updateRefundCardRecord(@Valid ShopRefundCardRecordUpdateReqVO updateReqVO);

    /**
     * 删除退卡记录
     *
     * @param id 编号
     */
    void deleteRefundCardRecord(Long id);

    /**
     * 获得退卡记录
     *
     * @param id 编号
     * @return 退卡记录
     */
    ShopRefundCardRecordDO getRefundCardRecord(Long id);

    List<ShopRefundCardRecordDO> getMemberRefundCardRecord(Long memberId);

    /**
     * 获得退卡记录列表
     *
     * @param ids 编号
     * @return 退卡记录列表
     */
    List<ShopRefundCardRecordDO> getRefundCardRecordList(Collection<Long> ids);

    /**
     * 获得退卡记录分页
     *
     * @param pageReqVO 分页查询
     * @return 退卡记录分页
     */
    PageResult<ShopRefundCardRecordDO> getRefundCardRecordPage(ShopRefundCardRecordPageReqVO pageReqVO);

    /**
     * 获得退卡记录列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 退卡记录列表
     */
    List<ShopRefundCardRecordDO> getRefundCardRecordList(ShopRefundCardRecordExportReqVO exportReqVO);

}
